Gửi tin nhắn văn bản

Chúng tôi cung cấp một API gửi tin nhắn dạng văn bản đơn giản, dưới định danh của người dùng hoặc bot.

HTTP request

POST https://{app_id}.api.piscale.com/open-api/v1.0/chat/messages

Request body

Ví dụ

{   
    "sender": {
        // "bot_id": "6872016393689131",
        "user_id": "30043"
    },
    "target": {
        // "user_ids": ["30043"]
        "thread_id": "62046069159700"
    },
    "body": {
        "text": "Hello",
    }
}

Tên	Kiểu dữ liệu	Mô tả	Bắt buộc
sender.bot_id	string	Gửi dưới định dạng bot	✗
sender.user_id	string	Gửi dưới định danh user	✗
target.user_ids	array	Danh sách các user_id nhận	✗
target.thread_id	string	Mã cuộc hội thoại	✗
ext_user_ids	array	Danh sách ext_user_id	✗
user_ids	array	Danh sách user_id	✗
body.text	string	Nội dung văn bản	✓

note

• sender sẽ bắt buộc phải có bot_id hoặc user_id. Người gửi tin phải xác định rõ là một chương trình tự động (bot) hoặc là một người dùng.
• target sẽ bắt buộc phải có thread_id hoặc user_ids. user_ids tối đa 100 phần tử.

Response

Nếu thành công, bạn sẽ nhận được phản hồi.

Ví dụ

{
    "message_code": "M200",
    "message": "Success"
}

Tên	Kiểu dữ liệu	Mô tả
message_code	string	Mã thông điệp. Xem chi tiết
message	string	Nội dung mã thông điệp